home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / usefull / lockit / lockit.doc < prev    next >
Encoding:
Text File  |  1993-08-13  |  7.6 KB  |  144 lines
  1.                                     LockIt
  2.                                        
  3.                     Copyright © 1993 by Anders Melchiorsen
  4.                        Version 1.1 - Released 13-Aug-93
  5.  
  6.     
  7.     LockIt will eat  all input events (i.e. signals from the mouse and  the
  8.     keyboard) until a password is  entered correctly. Thereby you can  lock
  9.     the Amiga for  input while  you're not  present; this  is helpful  when
  10.     friends or small kids are around. It will not uphold the system if it's
  11.     turned off or if somebody reboots, however.
  12.     
  13.                                   Arguments
  14.                                  ¯¯¯¯¯¯¯¯¯¯¯
  15.     In  the following  I will explain  the arguments  that LockIt  accepts.
  16.     These can be enter either on the command line via the Shell, or in  the
  17.     tool types  of  the  icon,  via the  Information  window  of  WorkBench
  18.     (activated by clicking once on the  LockIt icon and the chose the  item
  19.     Information from the 'Icons' menu (or whatever they are called in  your
  20.     locale)). 
  21.     Let me  as an example take the  option PASSWORD: You can either use  it
  22.     from the Shell by typing a commandline like 'LockIt PASSWORD "go  on"',
  23.     or as a tool type, 'PASSWORD=go  on'. The difference is that you  enter
  24.     the option and its argument as two words in the Shell, but parted  with
  25.     an equal sign in the WorkBench.  Also note that you must embed 'go  on'
  26.     in double quotation marks  when using the Shell.  This is true for  all
  27.     Shell arguments that includes a space  - otherwise it would be  treated
  28.     as two arguments.
  29.     
  30.                                    The GUI
  31.                                   ¯¯¯¯¯¯¯¯¯
  32.     When  the GUI  option  is specified,  LockIt will  open a  window,  and
  33.     whenever a character  is entered, a  star will appear.  You can  delete
  34.     characters by using  the back space  key and this  will delete a  star,
  35.     too. All in all this gives a visual indication of the lock, instead  of
  36.     just freezing all input. When you use the GUI option, LockIt will print
  37.     a text in the  window. If you  don't like the  default, you can  simply
  38.     change it by  using the LEADTXT  option (the default  is 'Please  enter
  39.     password:').
  40.     If  you don't enable the  GUI option, then  entering the password  will
  41.     work slightly  diffrent: first  of all  you  will not  be able  to  see
  42.     anything, but what's  more important  is that  you can't  use the  back
  43.     space key to delete the most recently entered character (i.e. you can't
  44.     correct mistakes). If  you make a  mistake, just start  over again,  as
  45.     LockIt will simply lock input  until the password is entered  correctly
  46.     without interruptions (in the term of  wrong characters - you can  take
  47.     as long as you wish to enter the password).
  48.     
  49.                               Defining password
  50.                              ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  51.     The  default password  is  'let me  in'.  This can  be altered  by  the
  52.     PASSWORD option. If you want the Enter key to be a part of the password
  53.     (most likely when the GUI option is used), you must add this  yourself.
  54.     This can be done by typing Ctrl-M if you use the icon tool types via WB
  55.     (this will show as a rectangle, if entered correct). Depending on  what
  56.     Shell you are using, you might be  able to add a Ctrl-M that way,  too.
  57.     If you use the GUI option, a maximum of 50 characters is allowed.
  58.     
  59.                                Invoking LockIt
  60.                               ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  61.     The best way to use LockIt is to use  some utility like QMouse, DirWork
  62.     or Yak to assign the command  'LockIt' plus your password (and  perhaps
  63.     the GUI option) to a hotkey. Then you only has to press that hotkey  to
  64.     lock the  input stream  and you  don't  need to  fiddle with  Shell  or
  65.     Workbench. 
  66.     You  could  also  put  LockIt  it  in  the  s:startup-sequence  or  the
  67.     WBStartup drawer of your disk, and this way your Amiga will get locked,
  68.     even if  somebody reboots.  This reboot  lock, however,  can easily  be
  69.     broken by anyone who  knows just a little  bit about the Amiga.  Please
  70.     note that if you're using the  GUI option, you should not start  LockIt
  71.     before you've run IPrefs, as this will probably give a weird display.
  72.     
  73.                           Additional considerations
  74.                          ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  75.     LockIt  uses a CTRL-C to  signal to itself that  a correct password  is
  76.     entered. This means  that it  can be  broken by  e.g. Commodores  Break
  77.     program (in the  C: drawer). If  you consider this  a drawback,  please
  78.     start thinking about how anyone should get to execute the Break program
  79.     while the Amiga  is locked.  This is only  possible if  someone uses  a
  80.     delayed Break, which should  be installed before  the locking. In  fact
  81.     this allows you to lock the  computer for a specified maximum time,  so
  82.     it's a feature, actually :-)
  83.     
  84.     As Kickstart  1.3 is outdated by now,  no attemp has been done to  keep
  85.     LockIt running on Kickstarts below 2.0. However, if you don't start  it
  86.     from CLI/Shell, but only from the Workbench, it will still run. This is
  87.     because I use an Shell argument handling routine that is only available
  88.     on Kickstart 2.0 and above.
  89.     
  90.     Please don't blame  me for the icon. It's ugly, and I know it, but  I'm
  91.     a programmer,  not a  graphics artist.  If you  should come  up with  a
  92.     better one, please  send it  to me,  and I  will include  it in  future
  93.     releases that might be, and you'll get some credit as well.
  94.     
  95.     By  the way: LockIt  is in the  Public Domain,  whatever that may  mean
  96.     nowadays. The one thing that is sure is that I won't get rich no matter
  97.     what I allow, so use LockIt (including source) in any way you please.
  98.     
  99.                                     Credits
  100.                                     ¯¯¯¯¯¯¯
  101.     LockIt is inspirated by KeyLock by Andry Rachmat. I  was unable to find
  102.     his source so I wrote a locker myself, adding a few new things as well.
  103.     The two major differences are that  I believe LockIt works; I know  for
  104.     sure that  KeyLock doesn't.  Also, LockIt  has the  ability to  open  a
  105.     window, so you can see what's going on.
  106.     
  107.     Big  hellos to  all  points at  The Zone  (2:230/314@Fido),  especially
  108.     Christian Selmer for his suggestion of the GUI option.
  109.     
  110.                                     Source
  111.                                     ¯¯¯¯¯¯
  112.     I have included the source, just in case you  might want to take a look
  113.     at it. It's written in DICE C (I'm currently using 2.07.54R) and should
  114.     compile with 'dcc LockIt.c -oLockIt -2.0' or similar.
  115.     
  116.                                 Author address
  117.                                 ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  118.     If you use this program or it's source, if  you find any bugs, have any
  119.     suggestions or if  you just  feel like it,  then I  would appreciate  a
  120.     small letter or, if you have  modem access, a NetMail. This is where  I
  121.     can be reached:
  122.     
  123.     Anders Melchiorsen
  124.     Gammel Skivevej 39
  125.     7870 Roslev
  126.     Denmark
  127.     
  128.     2:230/314.10@FidoNet
  129.     
  130.                                    History
  131.                                   ¯¯¯¯¯¯¯¯¯
  132. Date      Size  Version  Comments
  133. 30-Jul-93 1668  1.0      Initial release.
  134.  
  135. 13-Aug-93 3616  1.1      Added GUI option by suggestion of Christian Selmer.
  136.                          Now only eats RAWMOUSE and RAWKEY events. Would not
  137.                          abort properly if an allocation failed. Changed name
  138.                          from InputLock to LockIt, as Simon Gramstup pointed
  139.                          out that the InputLock name had been used by Preben
  140.                          Nielsen already.
  141.  
  142.  
  143.  
  144.